home *** CD-ROM | disk | FTP | other *** search
/ LOGIC 2000 February / LogicCd--feb.2000-mac-cdr.iso / Apple II / Utilities / Disk2File21 / DOCS.40 < prev    next >
Encoding:
Text File  |  1995-08-27  |  5.0 KB  |  204 lines  |  [TEXT/pdos]
  1.  
  2. DSK2FILE, VERSION 2.1
  3.  
  4. RONALD T. KNEUSEL, AUGUST 1995.
  5. FREEWARE
  6. (RKNEUSEL@POST.ITS.MCW.EDU)
  7.  
  8.  
  9. WHAT IS IT?
  10. -----------
  11.  
  12. DSK2FILE CREATES DISK IMAGES OF
  13. 5.25" DISKS (DOS 3.3 OR PRODOS) FOR
  14. USE WITH APPLE ][ EMULATOR PROGRAMS.
  15.  
  16. DSK2FILE WILL CREATE IMAGES IN DOS
  17. ORDER (.DSK) OR IN PRODOS ORDER
  18. (.PO)  IT DOES NOT MATTER WHAT FORMAT
  19. THE DISK REALLY IS, YOU CAN USE 
  20. EITHER ORDER.  MOST EMULATORS WILL
  21. HANDLE DOS ORDER, SOME WILL ALSO
  22. HANDLE PRODOS ORDER.
  23.  
  24.  
  25. WHAT DO I NEED TO RUN IT?
  26. -------------------------
  27.  
  28. YOU NEED A 5.25" DRIVE, AND ONE OF
  29. THE FOLLOWING:
  30.  
  31. (1) 3.5" DRIVE
  32. (2) A HARD DRIVE
  33. (3) A RAM CARD WITH 150K OR MORE
  34.  
  35. DSK2FILE WILL CREATE THE FILE, IT
  36. IS UP TO YOU DO GET THE FILE TO 
  37. THE PC OR MAC.  SEE BELOW FOR
  38. SUGGESTIONS ON HOW TO DO THIS.
  39.  
  40.  
  41. RUNNING DSK2FILE
  42. ----------------
  43.  
  44. DSK2FILE'S MENU HAS TWO CHOICES:
  45.  
  46. (1) 140K DISK -> IMAGE FILE
  47. (2) IMAGE FILE -> 140K DISK
  48.  
  49. YOU WILL LIKELY USE (1) THE MOST
  50. OFTEN.  THE SECOND OPTION IS FOR
  51. THOSE WHO MIGHT COME ACROSS AN
  52. IMAGE FILE AND WANT TO PUT THAT
  53. FILE BACK ONTO A DISK AND RUN
  54. IT ON A REAL APPLE ][.
  55.  
  56. (1) 140K -> IMAGE FILE
  57.  
  58. DSK2FILE READS ONLY 5.25"
  59. DISKS FROM SLOT 6, DRIVE 1. THE
  60. PROGRAM WILL ASK FOR AN IMAGE ORDER
  61. EITHER DOS 3.3 OR PRODOS AND THEN
  62. ASK FOR AN OUTPUT FILENAME.  THE
  63. APPROPRIATE EXTENSION IS ADDED
  64. TO THE FILENAME.  SPECIFY THE
  65. *COMPLETE* PATHNAME OF THE FILE, I.E.
  66. /RAM5/KARATEKA NOT JUST KARATEKA.
  67.  
  68. INSERT THE DISK WHEN ASKED AND PRESS
  69. RETURN.  THE IMAGE FILE WILL BE CREATED
  70.  
  71.  
  72. (2) IMAGE FILE -> 140K DISK
  73.  
  74.  INSERT A *FORMATTED* 5.25" DISK IN
  75. SLOT 6, DRIVE 1 AND SPECIFY THE
  76. *COMPLETE* PATHNAME OF THE IMAGE FILE
  77. AS ABOVE.  THE EXTENSION IS IMPORTANT,
  78. DSK2FILE USES IT TO DETERMINE WHAT
  79. ORDER THE IMAGE FILE WAS WRITTEN IN.
  80. IF THE IMAGE DIDN'T HAVE AN EXTENSION
  81. CHANGE ITS NAME TO HAVE .DSK AS THE
  82. EXTENSION.  IF IT DOESN'T WORK, CHANGE
  83. IT TO .PO AND TRY AGAIN.
  84.  
  85.  
  86. WHAT'S WITH THE DOS & PRODOS ORDERS?
  87. ------------------------------------
  88.  
  89. THE APPLE ][ HAS TWO DIFFERENT DISK
  90. OPERATING SYSTEMS: DOS 3.3 AND PRODOS.
  91. (YES, THERE ARE SEVERAL OTHERS, I'M
  92. SIMPLIFYING A BIT, I KNOW :)
  93.  
  94. DOS 3.3 IS THE OLDER AND SLOWER OF THE
  95. TWO AND DEALS IN 256 BYTE SECTORS WITH
  96. 16 SECTORS PER TRACK AND 35 TRACKS PER
  97. 5.25" DISK. PRODOS IS FASTER AND DEALS 
  98. WITH 512 BYTE BLOCKS, 280 PER 5.25" 
  99. DISK.  THEREFORE, EACH PRODOS BLOCK
  100. CORRESPONDS TO TWO SECTORS.  HOWEVER,
  101. THESE ARE NOT NECESSARILY CONTIGUOUS
  102. SECTORS.  PRODOS USES A DIFFERENT 
  103. PHYSICAL SPACING OF WHAT DOS 3.3 WOULD
  104. CALL SECTORS SO THAT READING ALL THE
  105. BLOCKS FROM 0 TO 279 IN ORDER WRITES
  106. THE DATA ON THE DISK TO THE FILE IN
  107. ONE ORDER WHILE USING TRACK 0 TO 34
  108. AND SECTOR 0 TO 15 FOR EACH TRACK WILL
  109. WRITE THE DATA IN A DIFFERENT ORDER.
  110. EITHER WAY, ALL THE DATA WILL BE
  111. WRITTEN, 143360 BYTES TOTAL.
  112.  
  113.  
  114. HOW DOES IT WORK?
  115. -----------------
  116.  
  117. GLAD YOU ASKED! :)
  118.  
  119. DSK2FILE MUST RUN UNDER PRODOS
  120. BECAUSE IT USES PRODOS MLI
  121. COMMANDS TO HANDLE THE DISK FILES.
  122. THIS RELIEVES THE USER FROM CARING
  123. ABOUT THE FILE TYPE OF THE IMAGE
  124. FILE.  IT ALSO MAKES IT MUCH EASIER
  125. THAN USING OLD DOS 3.3 RWTS CALLS.
  126.  
  127. THE DISK IS READ, BLOCK BY BLOCK
  128. AND WRITTEN TO THE OUTPUT FILE IN
  129. 512 BYTE SECTIONS.  IF THE OUTPUT
  130. IS TO BE IN DOS 3.3 ORDER A MAP
  131. IS APPLIED TO THE BLOCK NUMBER TO
  132. TRANSLATE IT INTO A TRACK AND SECTOR
  133. WITH THE APPROPRIATE 256 BYTE SECTION
  134. OF THE BLOCK BEING WRITTEN.  THIS
  135. IS THE EASY PART.
  136.  
  137. WRITING AN IMAGE TO A DISK IS JUST
  138. AS EASY IF THE IMAGE IS IN PRODOS
  139. ORDER.  READ 512 BYTES FROM THE
  140. FILE AND WRITE IT TO BLOCK 0 AND
  141. SO ON.  IF IT IS A DOS 3.3 ORDER
  142. IMAGE FILE LIFE GETS A BIT TRICKY SINCE
  143. WE CAN ONLY READ AND WRITE 512 BYTE 
  144. BLOCKS BUT WE ARE WORKING WITH
  145. HALF A BLOCK AT A TIME.  THE SOLUTION
  146. IS TO READ THE EXISTING BLOCK, THEN
  147. READ THE 256 BYTES FROM THE IMAGE FILE
  148. AND PUT IT IN THE RIGHT HALF OF THE
  149. BLOCK BUFFER.  THEN WRITE THE ENTIRE
  150. BLOCK BACK TO DISK.  THIS IS WHY
  151. GOING FROM A DOS 3.3 IMAGE FILE TO
  152. A DISK TAKES LONGER.
  153.  
  154.  
  155. WHAT DO I DO WITH THE IMAGE FILE?
  156. ---------------------------------
  157.  
  158. THE END GOAL, OF COURSE, IS TO GET THE
  159. FILE TO A PC OR MACINTOSH (OR UNIX BOX)
  160.  
  161. I USE A TERMINAL PROGRAM TO UPLOAD
  162. THE IMAGE FILE (WRITTEN TO MY RAM CARD)
  163. TO A UNIX BOX AND THEN DOWNLOAD IT TO
  164. THE MAC OR PC. (REALLY, I FTP IT SINCE
  165. I HAVE INTERNET ACCESS)  ANOTHER OPTION
  166. IS TO USE A NULL MODEM CABLE AND GO
  167. DIRECTLY TO A PC OR MAC WITH THE IMAGE
  168. FILE.  LASTLY, YOU COULD WRITE THE FILE
  169. TO A 3.5" PRODOS DISK AND USE A MAC TO
  170. READ THE FILE WITH APPLE FILE EXCHANGE.
  171. THEN YOU COULD WRITE THE FILE TO A PC
  172. DISK IF NEED BE.
  173.  
  174.  
  175. IT DOESN'T WORK, NOW WHAT?
  176. --------------------------
  177.  
  178. CONTACT ME AT THE EMAIL ADDRESS ABOVE.
  179. IF YOU START SEEING TWO DIGIT HEX
  180. NUMBERS PLEASE WRITE THEM DOWN TO HELP
  181. ME IN THE DEBUGING.  THESE ARE PRODOS
  182. MLI ERROR CODES.  DSK2FILE WILL NOT
  183. READ COPY PROTECTED DISKS. DISKS WITH
  184. BAD BLOCKS OR SECTORS WILL STILL BE
  185. WRITTEN TO AN IMAGE FILE WITH NONSENSE
  186. IN THE BAD BLOCK OR SECTOR. (ACTUALLY,
  187. IT WILL BE THE DATA THAT WAS IN THE 
  188. LAST BLOCK OR SECTOR SUCCESSFULLY READ)
  189.  
  190.  
  191. I'M IN THE DARK AGES AND DON'T HAVE
  192. EMAIL, HOW DO I CONTACT YOU?
  193. -----------------------------------
  194.  
  195. IF YOU FEEL A COMPELLING NEED YOU
  196. CAN TRY SNAIL MAIL:
  197.  
  198. RON KNEUSEL
  199. 8725 W BURDICK AVE
  200. MILWAUKEE, WI 53227 USA
  201.  
  202. AMDG
  203.  
  204.